home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-01 / ddj9304.zip / WAVELET.ZIP / README.TXT < prev    next >
Text File  |  1992-05-22  |  10KB  |  227 lines
  1.            Users Guide for the Wavelet Analyzer
  2.  
  3. HARDWARE CONFIGURATION
  4.  
  5.     The wavelet analyzer program, ANALYZER.EXE, is supplied with
  6. two configuration files, ANALYZER.C0G and ANALYZER.C1G.  The
  7. first file is for use with a Burr-Brown ZPB32 DSP board with a
  8. base address of 0x300.  The second is for use with a ZPB34 DSP
  9. board with a base address of 0x310.  Select the appropriate
  10. configuration file for the DSP board you have and rename it to
  11. ANALYZER.CFG.  The DSP COFF files, ANLYZR32.DSP and ANLYZ32C.DSP,
  12. are for the ZPB32 and ZPB34, respectively.  Only one of these
  13. COFF files are used at any time; the unused COFF file can be
  14. deleted if desired.
  15.  
  16.     If neither configuration file is appropriate for your needs,
  17. running ANALYZER.CFG without ANALYZER.CFG will result in the
  18. generation of a new configuration file.  You will be prompted for
  19. the board type and its base address.  Once the configuration data
  20. is properly entered, ANALYZER.EXE will proceed with its exection
  21. to the main screen.
  22.  
  23.     The only commercial DSP boards currently supported are the
  24. Burr-Brown DSP boards mentioned above.  In addition to the DSP
  25. board, a ZPB100 codec board is also required for analog I/O.  The
  26. CODYBOARD is a homemade board I constructed using the AT&T DSP32
  27. and a codec on one IBM PC-AT board.  The Burr-Brown DSP boards
  28. can now be purchased from Intelligent Instrumentation, a Burr-
  29. Brown company.  Their address is:
  30.  
  31.                Intelligent Instrumentation, Inc.
  32.                1141 West Grant Road, MS131
  33.                Tucson, AZ 85705
  34.                Telephone: (602) 624-2434
  35.                FAX: (602) 623-8965
  36.  
  37.     The ZPB100 codec board should be jumpered to pass the
  38. incomming audio signal through the input amplifier prior to
  39. entering the codec.  The gain of the input amplifier should be
  40. adjusted so that the maximum voltage at the input of the codec
  41. does not exceed 1.578 volts peak.  Consult the ZPB100 manual for
  42. specific jumper settings.
  43.  
  44.  
  45. WAVELET ANALYZER OPERATION
  46.  
  47.     Once the main screen appears, you will see that there are
  48. thirteen control positions running along the lefthand side of the
  49. display.  The top eight positions control the vertical scale of
  50. the eight input signal and wavelet transform coefficient traces. 
  51. The bottom five positions control the freezing of the display,
  52. the execution of the transform, the selection of alpha and beta,
  53. and the termination of the program.  These thirteen controls are
  54. selected and controlled in the following manner:
  55.  
  56. Control Selection
  57.  
  58.   <Up Arrow> - Pressing this key moves the active control selection
  59.                indicator up the screen.  When either the ALPHA or
  60.                BETA control is selected, its entry field is also
  61.                enabled.  Pressing the key during an ALPHA or BETA
  62.                entry aborts the entry, restores the original
  63.                value, and disables the entry field.  Pressing the
  64.                key when the INPUT vertical scale setting control
  65.                is selected causes no action.
  66.  
  67.   <Down Arrow> - Pressing this key moves the active control
  68.                  selection indicator down the screen.  When
  69.                  either the ALPHA or BETA control is selected,
  70.                  its entry field is also enabled.  Pressing the
  71.                  key during an ALPHA or BETA entry aborts the
  72.                  entry, restores the original value, and disables
  73.                  the entry field.  Pressing the key when the
  74.                  lowest active control is selected (QUIT when the
  75.                  transform is not running, HALT when it is
  76.                  running) causes no action.
  77.  
  78.   <Page Up> - Pressing this key moves the active control
  79.               selection indicator up to the INPUT vertical scale
  80.               setting control at the top of the screen.  Pressing
  81.               the key during an ALPHA or BETA entry aborts the
  82.               entry, restores the original value, and disables
  83.               the entry field.  Pressing the key when the INPUT
  84.               vertical scale setting control is selected causes
  85.               no action.
  86.  
  87.   <Page Down> - Pressing this key moves the active control
  88.                 selection indicator down to the lowest active
  89.                 control on the screen (QUIT when the transform is
  90.                 not running, HALT when it is running).  Pressing
  91.                 the key during an ALPHA or BETA entry aborts the
  92.                 entry, restores the original value, and disables
  93.                 the entry field.  Pressing the key when the
  94.                 lowest active control is already selected causes
  95.                 no action.
  96.  
  97.  
  98. Vertical Scale Controls
  99.   <Left Arrow> - Pressing this key increments the vertical scale
  100.                  setting for the selected wavelet transform level
  101.                  or input trace.  The maximum vertical scale is
  102.                  ±1.0.
  103.  
  104.   <Right Arrow> - Pressing this key decrements the vertical scale
  105.                   setting for the selected wavelet transform
  106.                   level or input trace.  The mimimum vertical
  107.                   scale is ±0.001.
  108.  
  109.  
  110. Wavelet Transform Controls
  111.   RUN / HALT - Pressing the <Enter> key toggles running of the
  112.                fast wavelet transform loaded on the DSP board. As
  113.                the transform runs, the input data and the
  114.                transform coefficients scroll across the display. 
  115.                The coefficients scroll at different rates due to
  116.                increasing time dilation at lower levels of the
  117.                transform.
  118.  
  119.   HOLD / CONTinue - Pressing the <Enter> key toggles freezing of
  120.                     the scrolling display.  Page flipping of the
  121.                     graphics display is suppressed and only the
  122.                     hidden display page is updated.  When
  123.                     scrolling is CONTinued, the display resumes
  124.                     with the image saved on the hidden page, as
  125.                     if the diplay had no been frozen.
  126.                
  127.   ALPHA / BETA - The only keys recognized are the numbers
  128.                  ('0' -'9'), the minus key ('-'), the period key
  129.                  ('.'), the <Backspace> key, and the <Enter> key.
  130.                  The <Backspace> key is used to edit entries into
  131.                  the fields.  The <Enter> key completes the field
  132.                  entry.  If the new value is valid and within
  133.                  range (-π ≤ α,ß < π), it is accepted.  A value
  134.                  different from the original value causes
  135.                  calculation and display of the new scaling and
  136.                  wavlet functions.
  137.   
  138.   QUIT - Pressing the <Enter> key when QUIT is selected causes
  139.          termination of the Wavelet Analyzer and return to DOS.
  140.  
  141.  
  142. Here are some example values for alpha and beta:
  143.  
  144.      ALPHA          BETA                  DISCRIPTION
  145.  (equals beta) (equals alpha)  Haar 2-coefficient wavelet,
  146.                                              vanishing 0th moment
  147.  
  148.   1.047197551        0.0       Daubechies 4-coefficient wavelet,
  149.                                              vanishing 1st moment
  150.  
  151.   1.3598037324  -0.782106385   Daubechies 6-coefficient wavelet,
  152.                                              vanishing 2nd moment
  153.  
  154. Note: The greater the number of vanishing moments, the better the
  155. wavelet is capable of reducing energy in the high frequency terms
  156. of the transform coefficiets.
  157.  
  158.  
  159. COMPILING THE WAVELET ANALYZER CODE
  160.  
  161.     The wavelet analyzer C code is written in Turbo C 2.0 and
  162. compiled using the Borland Integrated Development Environment
  163. (IDE).  The assembly language code elements in V592X480.C and
  164. DSP_CTRL.C are generated through the __emit__ facility.  Though
  165. not as clean or transportable as inline assembly or a separate
  166. language module, it does allow compilation within IDE.  Going
  167. this route, I didn't have to learn as much about assembly
  168. language programming or use the Borland command-line compiler
  169. (TCC) either.  Perhaps, in a future version of this software,
  170. I'll bite the bullet and really learn assembler and/or use TCC.
  171.  
  172.     For those wanting to use TCC or another compiler, I have
  173. provided the Integrated Make project file and the following list
  174. of compiler and optimization switch settings taken from my Turbo
  175. C IDE:
  176.  
  177.    Calling convention        C
  178.    Instruction set           80186/80286
  179.    Floating point            Emulation
  180.    Default character type    Signed
  181.    Alignment                 Word
  182.    Generate underbars        On
  183.    Merge duplicate strings   On
  184.    Standard stack frame      On
  185.    Test stack overflow       On
  186.    Optimize for              Speed
  187.    Use register variables    On
  188.    Register optimization     On
  189.    Jump optimization         Off
  190.  
  191. Using this information and the project file should allow the
  192. creation of a make file for TCC.  For those who wish to use
  193. Borland's later compilers, it is necessary to carefully analyze
  194. the compiled code generated by the mix of assembly and C code. 
  195. Those who wish to use C compilers other the Borland's will also
  196. have to translate Borland-specific library calls (including
  197. __emit__) to comparable calls in their complers' libraries.
  198.  
  199.  
  200. A BIGGER, BETTER WAVELET ANALYZER?!
  201.  
  202.     If there is sufficient interest in such a commercial product,
  203. I would like to expand the features of the wavelet analyzer.
  204. These features would include:
  205.  
  206.         - Larger order wavelets
  207.         - The wavelet packet transform
  208.         - Screen dump facility
  209.         - Signal and transform data capture and storage
  210.         - Support of more DSP boards
  211.         - Greater sampling rates
  212.         - anything else useful for realtime wavelet analysis
  213.  
  214. Any and all comments and suggestions are welcome.  I can be
  215. reached either via GEnie MAIL as M.CODY1 or by writing
  216. (preferably) or calling me at:
  217.  
  218.                 Sunair Electronics, Inc.,
  219.                 3101 SW Third Avenue,
  220.                 Ft. Lauderdale, FL 33315-3389
  221.                 Telephone: (305) 525-1505
  222.  
  223. Hope you enjoy the wavelet analyzer and find it a useful tool!
  224.  
  225.  
  226.                                                   Mac A. Cody
  227.